home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Graphics Plus
/
Graphics Plus.iso
/
general
/
modelers
/
geomview
/
source.lha
/
Geomview
/
INSTALL
< prev
next >
Wrap
Text File
|
1993-11-16
|
4KB
|
83 lines
NOTE: This file is autogenerated from the Geomview manual.
For references to things not in this file, see the manual.
The manual is distributed in the "doc" subdirectory.
Compiling and Installing the Source Code Distribution
=====================================================
The main reason to get the source code distribution is to look at and/or
work with the source code. If you are only concered with *using*
Geomview it is better to get the binary distribution. It takes anywhere
from 15 minutes to 1.5 hours to compile the entire source distribution,
depending on what kind of computer you have.
Let `$GEOMROOT' denote the full pathname of the Geomview source
code directory; this is the directory called `Geomview' that is
created when you unpack the distribution. This directory contains the
Geomview source code as well as various other files and subdirectories
that Geomview needs when it runs.
Before doing any compilation you should edit the file
`$GEOMROOT/makefiles/mk.site.default'. This file defines some
`make' variables which specify your local configuration. This
includes the pathnames of the directories into which Geomview will be
installed, and possibly some other settings as well. There are comments
in the file telling you what to do. This file is included by every
Makefile in the source tree, so the settings you specify here are used
throughout the source.
If you will be compiling for both SGI and NeXT, you can do both in the
same directory tree. By default the Makefiles are set up to put the
objects files, libraries, and executables in directories which depend on
the type of computer, so the two architectures will not interfere with
each other. The Makefiles use a variable called `CPU' to determine
the type of machine. Before doing any compilation you must arrange for
this variable to have a value. There are two ways you can do this.
1. If you will always be compiling Geomview on the same type of computer
(SGI or NeXT), edit the file `$GEOMROOT/makefiles/Makedefs.global'
to set the `CPU' variable to either `iris4' or `NeXT'.
The comments near the top of that file will tell you where to do this.
2. If you will be compiling on both types of computers you can set a shell
environment variable named `CPU' to either `iris4' or
`NeXT', and the Makefiles will inherit the value from the
environment. The script `$GEOMROOT/config' determines which kind
of computer you are on and sets this variable accordingly. To use this
script, type `source config' in the (assuming a C-shell type shell)
in the `$GEOMROOT' directory shell in which you plan to do the
compilation. Or you can set the variable directly; it should be either
`NeXT' or `iris4'. You will need to do this in every shell in
which you plan to do compilation.
Alternately, you could modify your shell initialization file
(`.cshrc' or whatever) to set `CPU' appropriately.
Note that many of the Makefiles refer to a variable called `MACHTYPE'
to determine the type of machine. This is set to either `sgi' or
`next', depending on the value of `CPU'.
Once you have configured your source tree by editing the files as
described above and setting the `CPU' variable, you can compile and
install Geomview by typing `make install' in the `$GEOMROOT'
directory. You can also type `make all', or equivalently just
`make', to compile without installing, and then type `make
install' later to install.
You can use these same `make' comands in any subdirectory in the
tree to recompile and/or install a part of Geomview or a module.
If you want to compile fat binaries under NeXTStep 3.1, before doing any
compilation edit the file `$GEOMROOT/makefiles/mk.next' to
uncomment a particular line there. There are comments in the file
telling you which line to uncomment.
If you want to modify the complier flags used during compilation, edit
the file `$GEOMROOT/makefiles/Makedefs.global'; the `COPTS'
variable specifies the flags passed to the C compiler (cc).